前兩天，我們學會了：

• git remote：把本地專案綁定到遠端倉庫
• SSH key：讓本地 Git 和 GitHub 之間可以安全連線

今天，我們要把前面做好的 commit 真的送到遠端去
學會 Git 協作的第一步：git push。

什麼是 git push？

它的功能就是：

👉 把本地分支的 commit 推送到遠端倉庫

你可以把它想像成「把電腦裡的檔案上傳到 Google Drive」——只是 Git 不只是檔案，而是整個版本歷史。

示意圖：

[ Local Repo ]  --- git push --->  [ Remote Repo ]

基本用法

第一次推送（需要指定遠端與分支）

git push -u origin main

說明：

• origin：遠端的名稱（預設是 origin）
• main：要推送的分支名稱

參數 -u（等同於 --set-upstream）：

• 設定「本地分支 ↔ 遠端分支」的追蹤關係
• 之後就可以直接輸入：git push 不必每次指定 origin main

一般推送

git push

把本地的 commit 傳到預設的遠端分支。

推送其他分支

git push origin feature/login

把 feature/login 分支推上遠端。

強制推送（⚠️ 小心使用）

git push --force

會直接覆蓋遠端分支，可能導致別人 commit 消失。

建議只在 rebase 或確定自己是唯一協作者時使用。

常見錯誤 & 解法

1. 沒有設置 remote

   fatal: No configured push destination.
   

   👉 先用 git remote add origin ... 綁定遠端

2. SSH key 未設置或失敗

   👉 回去 Day 15，檢查 ssh -T git@github.com

3. 分支名稱不一致

   • 本地是 main，遠端還是 master

   • 解法：推送時明確指定

     git push -u origin main:master
     

小挑戰 💪

1. 在 GitHub 建立一個空倉庫

2. 在本地 init 並 commit 幾次

3. 新增遠端：

   git remote add origin git@github.com:yourname/project.git
   

4. 執行 git push -u origin main，觀察 GitHub 倉庫更新

5. 嘗試建立一個新分支，推送到遠端

小結

今天我們學到：

• git push 把本地 commit 推送到遠端
• 第一次推送要加 -u 建立追蹤關係
• 常見錯誤多半是 remote、SSH key、分支名稱不一致

有了 git push，我們終於能把本地歷史公開到遠端，正式進入團隊協作的世界